<!DOCTYPE html>
<html lang="en">
<head>
  <title>timers-in-node</title>
  <meta charset="UTF-8">
  <meta name="description" content="ltoddy's blog">
  <meta name="author" content="liutao">
  <meta name="author" content="ltoddy">
  <meta name="author" content="just for fun">

  <!-- 最新版本的 Bootstrap 核心 CSS 文件 -->
  <link rel="stylesheet" href="https://cdn.bootcss.com/bootstrap/3.3.7/css/bootstrap.min.css"
        integrity="sha384-BVYiiSIFeK1dGmJRAkycuHAHRg32OmUcww7on3RYdg4Va+PmSTsz/K68vbdEjh4u" crossorigin="anonymous">

  <!-- jQuert Microsoft CDN -->
  <script src="https://ajax.aspnetcdn.com/ajax/jQuery/jquery-3.3.1.min.js"></script>
  <!-- 最新的 Bootstrap 核心 JavaScript 文件 -->
  <script src="https://cdn.bootcss.com/bootstrap/3.3.7/js/bootstrap.min.js"
          integrity="sha384-Tc5IQib027qvyjSMfHjOMaLkfuWVxZxUPnCJA7l2mCWNIpG9mGCD8wGNIcPD7Txa"
          crossorigin="anonymous"></script>
</head>
<body>

<div class="container">
  <h1>Timers in Node.js and beyond</h1>
  <p>Node.js的定时器模块中含有这样的方法,它们可以设定在指定时间之后执行某些代码.
    定时器函数不需要通过 require() 导入,它们是全局可访问的,这是为了和浏览器中的JavaScript API保持一致.</p>
  <p>用Node.js控制时间连续体(Time Continuum)</p>
  <p>Node.js的API提供了几种方式来实现在当前时刻过后的某个时间点执行某些代码. 下面的几个函数很常见, 因为绝大多数浏览器中都有,
    但实际上Node.js对这些函数有着自己的实现方式. 定时器和操作系统密切相关, 尽管Node.js的API仿照了浏览器中的API, 但在具体实现上有些不同.</p>
  <h3>setTimeout()</h3>
  <p>setTimeout()用于设定在指定的毫秒数之后执行某些代码.这个函数和浏览器中的JavaScript API window.setTimeout() 类似, 然而Node.js的 setTimeout()
    不能传入字符串形式的代码.</p>
  <p>setTimeout() 的接收的第一个参数是要延迟执行的回调, 第二个参数是要延迟的毫秒数. 还可以传入更多的参数, 多出来的这些参数会被传入回调函数., 例如:</p>
  <pre><code>```javascript
function myFunc(arg) {
  console.log(`arg was =&gt; ${arg}`);
}

setTimeout(myFunc, 1500, 'funky');
```
</code></pre>
  <p>由于使用了 setTimeout(), 上例中的 myFunc() 将会在1500ms之后尽可能早地执行.</p>
  <p>不能够依赖设定的超时间隔来实现在精确的毫秒数之后就执行某些代码. 这是因为其他正在执行的阻塞或持续占用事件循环的代码会导致所设定函数推迟执行.
    唯一能保证的是所设定的函数不会在设定的超时间隔之前执行.</p>
  <p>setTimeout() 返回一个用来引用所设置的超时任务 Timeout 对象. 这个对象可以用来取消超时任务(见下方的 clearTimeout()),
    也可以改变执行任务时的行为(键下方的 unref()).</p>
  <h3>setImmedate()</h3>
  <p>setImmedate() 可以设置要在本次事件循环结束时执行的代码. 这些代码将会在本次事件循环的所有I/O操作之后, 且在下次事件循环的所有定时器之前执行. 这种代码的执行可以认为是”在这之后”立刻发生的, 也就是说所有紧随
    setImmedate() 之后的函数调用会在 setImmedate() 所设定的回调函数之前执行.</p>
  <p>setImmedate() 的第一个参数是即将被执行的回调函数, 所有之后的参数都将被传入回调函数, 例如:</p>
  <pre><code>```javascript
console.log('before immediate');

setImmediate((arg) =&gt; {
  console.log(`executing immediate: ${arg}`);
}, 'so immediate');

console.log('after immediate');
```
</code></pre>
  <p>上面被传入 setImmedate() 的回调会在所有可执行代码执行完成之后才被调用, 运行上述代码控制台输出为:</p>
  <pre><code>```
before immediate
after immediate
executing immediate: so immediate
```
</code></pre>
  <p>setImmedate() 返回一个用于取消该任务的 Immedate 对象(见下方 clearImmediate()).</p>
  <p>注意: 不要把 setImmedate() 和 process.nextTick() 搞混了. 它们之间有几点主要的差异:</p>
  <ul>
    <li>
      <p>process.nextTick() 会在所有 setImmedate() 设定的回调和所有I/O之前执行</p>
    </li>
    <li>
      <p>process.nextTick() 是不可清除的, 也就是说一旦使用 process.nextTick() 设置了回调, 就无法再取消了.</p>
    </li>
  </ul>
  <h3>setInterval()</h3>
  <p>如果需要定期多次执行一些代码, 用 setInterval() 可以做到. setInterval() 接收一个回调函数作为第一个参数,
    接收一个毫秒数的时间间隔作为第二个参数, 然后每过时间间隔就执行一次回调函数.就像 setTimeout() 一样, 额外的参数会被传入回调函数,
    而且延迟时间也和 setTimeout() 一样无法保证精确, 因为可能有其他操作持续占用事件循环, 因此这个时间间隔应认为是近似间隔. 例如:</p>
  <pre><code>```javascript
function intervalFunc() {
  console.log('Cant stop me now!');
}

setInterval(intervalFunc, 1500);
```
</code></pre>
  <p>在上面例子中, intervalFunc 大概每1500ms执行一次, 一直到它被取消(详情见下文).</p>
  <h2>清除将来要执行的任务</h2>
  <p>如果需要取消 Timeout 或 Immediate 将来的执行该怎么办? setTimeout(), setImmediate() 和 setInterval() 会返回引用该 Timeout 或 Immediate 的对象.
    通过把刚刚提到的那些对象传入相应的 clear 函数并执行, 那些对象就会被彻底停止. 这几个函数是 clearTimeout(), clearImmediate() 和 clearInterval().
    看下面的例子:</p>
  <pre><code>```javascript
const timeoutObj = setTimeout(() =&gt; {
  console.log('timeout beyond time');
}, 1500);

const immediateObj = setImmediate(() =&gt; {
  console.log('immediately executing immediate');
});

const intervalObj = setInterval(() =&gt; {
  console.log('interviewing the interval');
}, 500);

clearTimeout(timeoutObj);
clearImmediate(immediateObj);
clearInterval(intervalObj);
```
</code></pre>
  <h2>把Timeouts放在后面</h2>
  <p>setTimeout() 和 setInterval() 返回的 Timeout 对象提供了 unref() 和 ref() 两个方法用以增强该对象的行为.
    如果有一个使用 set 函数设置的 Timeout 对象, unref() 方法可以在该对象上被调用.
    这会稍微改变对象的行为: 如果该 Timeout 是最后要执行的代码, 则不去调用该 Timeout. 此时的 Timeout 对象不会保持进程为活动状态, 会等待被调用.</p>
  <p>以此类推, 对于一个调用过 unref() 的 Timeout 对象, 可以调用它的 ref() 对象来撤销 unref() 所导致的改变, 这会使该 Timeout 对象稍后又可以被调用.
    然而要明白的是, 由于性能原因, 这种做法无法精确地恢复到最初的行为. 例子如下:</p>
  <pre><code>```javascript
const timerObj = setTimeout(() =&gt; {
  console.log('will i run?');
});

// if left alone, this statement will keep the above
// timeout from running, since the timeout will be the only
// thing keeping the program from exiting
timerObj.unref();

// we can bring it back to life by calling ref() inside
// an immediate
setImmediate(() =&gt; {
  timerObj.ref();
});
```
</code></pre>
</div>
<a href="https://github.com/ltoddy/ltoddy.github.io" target="_blank"><img
    style="position: absolute; top: 0; right: 0; border: 0;"
    src="https://camo.githubusercontent.com/38ef81f8aca64bb9a64448d0d70f1308ef5341ab/68747470733a2f2f73332e616d617a6f6e6177732e636f6d2f6769746875622f726962626f6e732f666f726b6d655f72696768745f6461726b626c75655f3132313632312e706e67"
    alt="Fork me on GitHub"
    data-canonical-src="https://s3.amazonaws.com/github/ribbons/forkme_right_darkblue_121621.png">
</a>
</body>
</html>